home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr52 / syscheck.zip / SYSCHECK.DOC next >
Text File  |  1993-05-13  |  2KB  |  64 lines
  1.  
  2.   Syntax :  SYSCHECK <handles> <memory> [<userid> [<errorfile>]
  3.  
  4.     where: <handles>   - Number of file handles required (256 max).
  5.            <memory>    - Memory required (640k max).
  6.            <userid>    - Optional - user ID to report to screen and
  7.                          error file (max length = 20 characters).
  8.            <errorfile> - Optional - path/name of error text file
  9.                          (max length = 50 characters).
  10.  
  11.   SYSCHECK returns the following DOS ERRORLEVEL codes:
  12.  
  13.               0     File handles and memory are sufficient
  14.               1     Not enough available file handles
  15.               2     Not enough available memory
  16.               3     Invalid parameters passed to SYSCHECK
  17.  
  18.   As optional features, a user's ID or name can be reported to an
  19.   error text file.
  20.  
  21.   *************************************************************************
  22.  
  23.   Example (Using SYSCHECK in a batch file before calling a CLIPPER program)
  24.  
  25.   @echo off
  26.   cls
  27.  
  28.   rem Check file handles and memory, report USERID to the file ERROR.TXT
  29.   rem NOTE: The %variable% syntax used in a batch file is the means
  30.   rem       of reading an external DOS environment variable.
  31.   syscheck 55 505 %userid% error.txt
  32.  
  33.   rem Branch according to the ERRORLEVEL return code from SYSCHECK
  34.   if errorlevel==0 goto okay
  35.   if errorlevel==1 goto handles
  36.   if errorlevel==2 goto memory
  37.   if errorlevel==3 goto oops
  38.  
  39.   :okay
  40.   rem Run your CLIPPER program
  41.   yourprog.exe
  42.   goto end
  43.  
  44.   :handles
  45.   echo Insufficient available file handles to run YOURPROG
  46.   echo (additional instructions here!)
  47.   pause
  48.   goto end
  49.  
  50.   :memory
  51.   echo Insufficient memory to run YOURPROG
  52.   echo (additional instructions here!)
  53.   pause
  54.   goto end
  55.  
  56.   :oops
  57.   echo Invalid SYSCHECK parameters
  58.   echo (additional instructions here!)
  59.   pause
  60.  
  61.   :end
  62.   *************************************************************************
  63. }
  64.